home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 10 / q10.d81 / t.shell asm < prev    next >
Text File  |  2022-08-28  |  20KB  |  496 lines
  1.  
  2.            L O A D S T A R   1 2 8   E D I T O R / A S S E M B L E R
  3.  
  4.                              by Robert Rockefeller
  5.  
  6.  
  7.     The Loadstar 128 Editor/Assembler package is a necessary tool for
  8. writing machine language.  You must know how to do it already -- this will
  9. not teach you -- but it will make it a LOT easier.  This article will only
  10. document the assembler/editor features.
  11.  
  12.     The editor, named "COM.EDT", and the assembler, named "COM.ASM", are
  13. designed to be used in conjunction with the shell program published on this
  14. issue of LOADSTAR.  Execute the shell program by typing RUN"128 SHELL" then
  15. type RETURN.
  16.  
  17. EDITOR
  18. ------
  19.  
  20.     The editor is a full-screen programmer's text editor which creates PET
  21. ASCII program files.  A programmer's text editor differs from a
  22. wordprocessor in that it typically cannot format and print out text files. 
  23. It's for editing code only.
  24.  
  25.     After the shell is loaded, you execute the editor by typing EDT then
  26. RETURN.  A file can be specified for editing by following EDT with a
  27. filename.  For example, if EDT "ASM.COPY is executed the editor will be
  28. loaded, then the text file "ASM.COPY" will automatically be loaded into the
  29. editor from disk device 8.  An alternate device number for the text file can
  30. be specified by prefixing it to the filename.  For example, EDT 9,"ASM.COPY
  31. would try to load "ASM.COPY" from device 9.
  32.  
  33.     EDT can work on files completely in RAM by specifying EDT RAM instead of
  34. a filename.  Typically you would use EDT to create a text file to be
  35. assembled.  You would then exit the editor and assemble the file with ASM. 
  36. You could then type EDT RAM to re-edit the text already in RAM without the
  37. necessity of loading the text in from disk.  Of course you must be sure that
  38. the text has not been corrupted in any way in the meantime.  Therefore avoid
  39. loading in BASIC programs between uses of EDT if you wish to use the RAM
  40. option.  It is also a good idea to save a copy of your source code to disk
  41. after making changes just in case.
  42.  
  43.     EDT files are suitable for use by the "COM.SUBMIT" program published
  44. with the shell program. SUBMIT allows you to execute text in "SUB." files as
  45. if the text were entered at the keyboard.  You can use "SUB." files to
  46. redefine the function keys, RUN BASIC programs, control the assembler, etc. 
  47. If you're familiar with MS DOS, think of "SUB." files as "batch" files.
  48.  
  49.     Some keyboard conventions are used when explaining EDT functions.  F1 @
  50. means type the F1 key and release it, then type the @ key and release it.  A
  51. slash (/) is used to show that two keys are to be pressed simultaneously. 
  52. SHIFT/RETURN means press a SHIFT key and the RETURN key at the same time. 
  53. EDT functions are explained below.
  54.  
  55. ESC 1 - Set the text color.
  56.  
  57. ESC 2 - Set the screen color.
  58.  
  59. ESC @ - Clear text from the cursor position to the end of the file.
  60.  
  61. ESC a - Turn insert mode on.
  62.  
  63. ESC c - Turn insert mode off.
  64.  
  65. ESC d - Erase the whole line.
  66.  
  67. ESC g - Enable bell ringing for errors.
  68.  
  69. ESC h - Disable bell ringing for errors.
  70.  
  71. ESC j - Move the cursor to the start of the line.
  72.  
  73. ESC k - Move the cursor to the end of the line.
  74.  
  75. ESC n - Set the screen to normal (non-reversed) mode.
  76.  
  77. ESC p - Erase to the start of the line.
  78.  
  79. ESC q - Erase to the end of the line.
  80.  
  81. ESC r - Set the screen to reversed mode.
  82.  
  83. ESC v - Scroll the screen up.
  84.  
  85. ESC w - Scroll the screen down.
  86.  
  87. F1 @ - Read the disk error channel, or issue a disk command.  Type F1 @
  88. RETURN to read the error channel of the default disk drive.  To read some
  89. other device enter a device number followed by a comma.  For example type F1
  90. @ 9, RETURN to read the error channel of device 9.  To issue a disk command
  91. just type F1 @ then type the command at the prompt, and type RETURN.  To
  92. send a command to a device other than the default device number, just prefix
  93. the device number to the command.  For example, typing F1 @ 9,i0 RETURN
  94. would initialize disk device 9.
  95.  
  96. F1 d - Set the default disk device number.  The default disk device number
  97. is always displayed as the number at the extreme left of the status line.
  98.  
  99. F1 m - Display the number of free bytes available for text storage.
  100.  
  101. F1 s - Search for a string.  Just enter the string at the prompt and type
  102. RETURN.
  103.  
  104. F1 e - Save the editor to disk.  First select the screen colors you like
  105. with ESC 1 and ESC 2, then type F1 e, then enter the disk device number to
  106. which you wish to save the editor, then type RETURN.
  107.  
  108. F1 r - Replace a string.  First enter the string to be replaced, then enter
  109. the string to replace with.  Finally, if you wish to be prompted before each
  110. replacement type y at the PROMPT BEFORE REPLACING? prompt, else type n.
  111.  
  112. F1 v - Display a text file on disk.  Enter the name of the file you wish to
  113. view then type RETURN.  The file will be printed to the screen.  To view
  114. from a disk other than the default disk you prefix a device number to the
  115. filename. For example, if you enter a filename of 9,ERR.COPY the file
  116. "ERR.COPY" would be displayed from device 9.
  117.  
  118. F1 b - Exit the editor.  Return to the BASIC environment.
  119.  
  120. RETURN - Start a new line.  Inserts a carriage-return character into the
  121. text area.  Any text to the right of the cursor will be moved to the next
  122. line when RETURN is typed.
  123.  
  124. CONTROL/p - Insert the text buffer at the cursor position.  Text can be
  125. copied into the text buffer by marking a block (see SHIFT/F7) then typing c.
  126.  
  127. SHIFT/HOME - Clear all text.  You must type y at the prompt before text is
  128. actually cleared.
  129.  
  130. HELP - Display help screens.
  131.  
  132. DEL - Delete the character to the left of the cursor.
  133.  
  134. CRSR keys - Work as you would expect them to.
  135.  
  136. down-arrow - Scroll the screen down one row.
  137.  
  138. up-arrow - Scroll the screen up one row.
  139.  
  140. HOME up-arrow - Move the cursor to the top, left corner of the screen.
  141.  
  142. HOME down-arrow - Move the cursor to the bottom, left corner of the screen.
  143.  
  144. HOME left-arrow - Move the cursor to the start of the text area.
  145.  
  146. HOME right-arrow - Move the cursor to the end of the text.
  147.  
  148. HOME cursor-down - Goto a specified line number.  Type the number of the
  149. line you wish to go to, then type RETURN.
  150.  
  151. F3 - Display a disk directory.  Enter the device number of the disk you wish
  152. to view.
  153.  
  154. F5 - Save the text to a disk drive.  Enter the filename at the prompt.  To
  155. save to a disk other than the default disk you prefix a device number to the
  156. filename.  For example, if you enter a filename of 9,SUB.KEYS the text would
  157. be saved to disk device 9 with the name "SUB.KEYS".
  158.  
  159. F7 - Delete the character under the cursor.
  160.  
  161. F2 - Load a file.  Enter the name of the file you wish to load.  To load
  162. from a disk other than the default you prefix a device number to the
  163. filename.  For example, if you enter a filename of 9,SUB.KEYS the file
  164. "SUB.KEYS" would be loaded from device 9.
  165.  
  166. F4 - Search ahead for the next occurrence of the last string searched for.
  167.  
  168. F8 - Begin marking a text block.  Move the cursor to the other end of the
  169. block.  The block is displayed in reverse field as the cursor is moved. 
  170. After the block is marked there are three operations that can be performed
  171. on the block.
  172.  
  173.     Type s to save the block to disk.
  174.  
  175.     Type c to copy the block to the text buffer.  The block can be inserted
  176. into the text area with CONTROL/p.
  177.  
  178.     Type DEL to delete the block.  The block is copied to the text buffer
  179. before deletion.  The block can be recovered with CONTROL/p.
  180.  
  181. ASSEMBLER
  182. ---------
  183.  
  184.     The assembler is executed by typing ASM and the name of a file to
  185. assemble, then RETURN.  For example, if ASM "COPY is executed the assembler
  186. will be loaded, then the source file "ASM.COPY" will be assembled.  All
  187. assembler source files must have ASM.  as the first four characters of their
  188. filenames.  However, leave off the ASM.  prefix when specifying filenames
  189. for the assembler.  The assembler automatically adds ASM. to each filename.
  190.  
  191.     ASM can assemble files completely in RAM by specifying ASM RAM instead
  192. of a filename.  Typically you would use EDT to create a text file to be
  193. assembled.  You would then exit the editor, and type ASM RAM to assemble the
  194. text already in memory without the necessity of loading the text in from
  195. disk.  If you load in a BASIC program in the meantime, however, the
  196. assembler may hav